QA 76.8 Т49 К46 1986 


LARKEN DISK CONTROLLER 
ғо” 75 2069 


By Larry Kenny 


SFECIFICATIONS 
- 160 K BYTES FER DISK 
- 125 K BITS PER SECOND 
- 2 K DOS ON EFROM f 
- USES SHUGART 54455 DRIVE OR COMFATÁBLE 
- CONTROLLER REQUIRES SUDC 8400 МА 
~ DRIVE REQUIRES SVIC 0400 MA AND 12UDC 0800 МА 
- THREE DATA TYPES : BASIC PROGRAMS › АККАҮС, MACHINE CODE 


OFERATION 
THE DISK OFERATING SYSTEM (DOS) USES 4k OF MEMORY AT THE TOF OF 
MEMORY. THE LOWER 2K IS USED AS A RAM BUFFER (ADDRESS 61440 TO 63487) 
ANI THE BANK SWITCHED EFROM USES ADDRESSES 63488 TQ 65535. THE BASIC 
COMMAND “OUT 84,64" BANK SWITCHES THE EFROM INTO THE 206875 MEMORY 
AND THE БАЅІС COMMAND "OUT 84,0“ SWITCHES THE EFROM OUT AND THE 
2068765 MEMORY IS БАСК TO THE USUAL FAM. BEFORE ENARLEING THE EFROM 
A "CLEAR 61000° COMMAND SHOULD BE EXECUTED TO MAKE ROOM FOR THE DOS. 
ENTRY TO THE POS IS BY а USR 63488 COMMAND EITHER A 'FRINT USR 63488° 
IN IMMEDIATE МОПЕ OR A "RANDOMIZE USR 63488" OR “LET XzUSR 63488" ІМ 
FROGKAM MODE. 
EG: TO ENTER DOS ИРОН FOUER UF 
CLEAR 61000 
OUT 84,64 
FRINT USR 63488 


LDOS 
x ( SHOULI! АРҒЕАК ON THE SCREEN) 


LIAS COMMANDS 
SIX COMMANDS ARE SUFPORTED IN THE EPROM VERSION OF. 1.05: 
DIRECTORY FORMAT LOAD *XXXXXX.TX' SAVE 'XXXXXX,TX"' 
DELETE 'XXXXXX.TX*' ANI! EXIT. ALSO BADELOCK MOVE AND COPY IN THE 
DISK VERSIONS. 
THESE COMMANDS DON'T USE TOKEN UORIS LINE THE TIMEX BASIC BUT ARE 
TYPED IN ‘ONLY THE FIRST 4 LETTERS ОҒ A COMMAND NEEL TO BE ТҮРЕП ІМ 
Ебі DELE “XXXXXX.EX® 





бҮМТАХ 
LOAD »SAVE ,СОРҮ » MOVE ANT DELETE REQUIRE A FILE NAME TO FOLLOW 
THE COMMAND. y ' 
THE FROFER SYNTAX FOR A FILE NAME IS: 


WHEN DATA ТҮРЕ IS ARRAY THE FIRST TWO CHARACTERS SFECIFY 
THE NAME OF THE ARRAY . EG: SAVE 'ASNAME.AX* WILL SEARCH 
FOR A CHARACTER ARRAY CALLED AS AND SAVE ІТ . THE SECOND 
CHARACTER HAS TO BE ETHIER A "$" SFECIFYING А CHARACTER 
ARRAY OR *'£' SPECIFYING A NUMERIC ARRAY. 


*XXXXXX,TX' 


/ ММ THE EXTENSION HAS TO 


BE 2 CHAFACTERS LONG 


THE FROGRAM NAME САМ BE UF TO THE РЕКІОП IS THE FIRST LETTER OF 
6 CHARACTERS AND CAN ВЕ ANY- A SEFARATOR AND THE EXTENSION SFECI- 
THING FOR BASIC AND CODE ТҮРЕ 15 COMFULSARY FIES UHAT TYFE OF 
FILES THE WHOLE FILE МАМЕ IS FILE IT IS EG: 
IN QUOTES A - ARRAY 

E - BASIC 

C - CODE 


THE LAST CHARACTER 
; ` CAN ВЕ ANYTHING 
- THE DISK VERSIONS SUFFORT STRING VARIABLES TO BE USED AS FILE NAMES 
EG: SAVE AS (A$ MUST BE DECLARED FREVIOSLY Еб LET 6$z*'PROG.EX*) 
ENTERING COMMANI!S 
COMMANDS MAY БЕ ENTERED IN IMMEDIATE MODE BY ENTERING LIOS WITH OUT 
А LINE NUMBER ON А FRINT USK 63488 STATMENT OR WITHIN А FRCGEAh. 
WHEN USING LIIOS WITHIN А FROGRAM USE а USR 6348€ CALL IN ONE STATMENT 
THEN THE NEXT STATMENT SHOULT БЕ А КЕМ STATMENT CONTAINING THE LIOS 
COMMAND . THEY САМ RE IN A MULTI-STATMENT LINE. 
EG: 
100 RANII'OMIZE USR 63488 
101 REM LOAD *'FROG2.R1" 
OR 
100 RANIIGMIZE USK 63488 ? REM LOAD *FROG2.R1' 


AUTO RUN PROGRAMS 

WHEN FROGRAM IS SAVEC WHILE THE PROGRAM IS RUNNING» IT WILL CONTINUE 

FROM THE NEXT LINE WHEN IT IS LOADED BACK ІМ. А STOF COMMANI! BEFORE 

THE SAVING LINES САМ BE USED TO PREVENT THE FROGRAM FROM RESAUING ITSELF 
. IF THE FROGRAM IS RUN A GOTO STATMENT САМ BE USED TO FIRST SAVE THE 

FROGRAM . 

EG: 

1 REM PROGRAM 


80 STOF 

90 RANDOMIZE USR 63488 
94'REM SAVE *'PROG.BR1*" 
95 GOTO i 


` ` к 
ТҮРЕ GOTO 90 TO START PROGRAM FOR THE FIRST TIME 





SAVEING 
NEW DISKS MUST BE FORMATTED BEFORE ГАТА CAN EE SAVED ON THEM. 
КАЅІС FROGRAMS ARE SAVEDI FROM THE START OF THE SYSTEM VARIABLES TO 
THE END OF THE PROGRAM VARIABLE AREA . ARRAYS AND VARIABLES CAN RE 
SAVED WITH THE FROGRAM.. 


MACHINE CODE OR MEMORY BLOCKS САМ BE SAVED BY FONEING START ADDRESS 
OF COLE INTO LOCATIONS 23540 (LSE) AND 23541 (MSR) AND LENTH OF ELOCK 
INTO LOCATIONS 23542 (LSE) AND 23543 (MSE) 
EG: TQ SAVE A CODE PROGRAM STARTING AT 50000 THAT IS 500 BYTES LONG 
256 Ж 195 + 80 =50000 
FOKE 23540780 
FOKE 235419195 
256 ж 1 + 244 =500 
FOKE 235425244 
ҒОКЕ 23543,1 
THEN SAVE *XXXXX.C1*' 
FOKING THESE LOCATIONS IS NOT NECESSARY WHEN LOADING BECAUSE THE 
CODE WILL ВЕ LOADED BACK IN WHERE IT WAS SAVED FROM. 
A BASIC FROGRAM FOR FOKING THESE LOCATIONS COULD БЕ ON DISK ANI! 
LOADED WHEN EVER NEEDED 
EG; 
10 REM AUTO FORKING PROGRAM 4 
20 FRINT “ENTER START ADIRESS "$: INFUT ASFRINT A 
30 LET В=ІМТ(А/256) LET C=A-(256%B) 
40 FORE 23540,;CiFONE 25541»В 
SO PRINT “ENTER LENTH *$;$:INFUT ASPRINT А 
60 LET BEINT(A/256)8LET С-А-(256ЖЕ) 
70 FOKE 23542,С:РОКЕ 2354398 


ARRAYS MUST ВЕ ALREADY DIMENSIONED IN MEMORY BEFORE THEY САМ BE 
SAVED ОК LOADED ОК A SYNTAX ERROR WILL RESULT. ALSO "DIM" STATMENTS 
TO BE SAVED OR LOADED MUST BE IN THE PROGRAM BEFORE SIMPLE VARIABLES 
OR FOR NEXT LOOPS. А MAXIMUM OF 6 ARRAYS САМ EE HANDLED BY LIOS IN 
ONE PROGRAM (ONLY THE EPROM DOS HAS THESE RESTRICTIONS) 
EG: 

10 DIM 6(1000) 

20 DIM 4% (500) 

25 LET B = 20 

30 FOR A = 1 TO 10 Goon 

40 NEXT A 

50 RANDOMIZE USR 63488 

55 REM SAVE *ASTEST.AL® 


20 DIM AC1000) 

20 LET В = 20 

30 FOR A = 1 TO 10 | А 
40 NEXT А РА BAD 

45 DIM A$(500) ` ж 

50 RANDOMIZE USR 63488 

60 REM SAVE *ASTEST.A1* 





LOADING с 
LOADING САМ BE DONE ІМ IMMEDIATE MODE OR WITHIN A PROGRAM . THE 
COMPUTER CAN EFFECTIULY RUN UF TO A 150K (АРКОХ.) FROGRAM BY LOADING 
NEW FROGRAMS IN WHEN IT NEEDS THEM. 
EXISTING FROGRAMS ON CASSETTE САМ ВЕ LOADED INTO THE COMFUTER THEN 
SAVED ON DISK. 
FORMATTING 

NEW DISKS MUST BE FORMATED BEFORE BEING USED BY THE FORMAT COMMAND. 
FORMATTING INITIALISES THE DIRECTORY AND WRITES ZEROS IN THE LATA 
FIELD ON ALL THE OTHER TRACKS.IT ALSO READS THE DATA BACK TO CHECK 
FOR CRC ERRORS (THIS IS А CHECK SUM THAT IS STORED ON THE TRACK OF 
ALL THE DATA ON THAT TRACK). 
а 6000 DISK SHOULI NOT HAVE ANY CRC ERRORS BUT SOMETIMES А HEAVILY 
GAUSSED DISK MAY HAVE TO BE FORMATED MORE THAN ONCE .REPEATED CRC 
ERRORS MEAN A DEFECTIVE DISK OR HARDWARE PROBLEM. 

USE A GOOD QUALITY DOUBLE SIDED »DOUBLE OR SINGLE DENSITY DISK. 
ALSO THE DISK HAS TO BE SOFT SECTORED (THESE АКЕ THE MOST COMMON USED) 
IF THE SYSTEM WILL SAVE AND LOAD FROGRAMS ОК ОМ A DISK IT HAS 
FORMATTED RUT WON'T READ A DISK THAT WAS FORMATTED ON AN OTHER 
LARKEN DISK DRIVE SYSTEM» THIS MEANS THAT ONE OR BOTH OF THE DRIVES 
IS GUT OF ALIGNMENT «THEY CAN BE ALIGNED BY MOST COMPUTER CENTERS. 
(REFER TO THE АКЕА ON EFROM DOS FOR MORE ON THIS) 

DISKS ARE FORMATTED FOR 80 5,1960 BYTE BLOCKS. 


DIRECTORY 
THE DIRECTORY COMMAND DISFLAYS ALL THE FILES ON THE DISK . А MAXI- 
MUM ОҒ 54 DIFFERENT FILES CAN BE CONTAINED. ON THE DISK VERSIONS OF 
LDOS THE LENTH OF EACH FILE IS INCLUDED AFTER THE NAME ANI! THE NUMBER 
OF ЕМРТҮ BLOCKS IS АТ THE END. WHEN А DISK FULL ERROR OCCURS THE 
PROGRAM NAME WILL АРРЕАК ON THE DIRECTORY BUT ІТ WILL SHOW NO BLOCKS 
USED THIS FILE SHOULD BE DELETED. 
DELETING 
FILES САМ EE DELETED WITH THE DELETE *XXXXX.TX* COMMAND . 
EXIT 
EXIT RETURNS YOU TO BASIC WHEN YOU АКЕ IN IMMEDIATE MODE. 


-- DISK VERSION EXTRA COMMANDS -- 

BADBLOCKS 

ON DISK VERIONS OF LDOS THIS COMMAND WAS INCLUDED TO CHECK DISKS 

FOR ERRORS .IT SCANS THE DISK AND TRIES TO READ EVERY TRACK . 

IF AFTER 10 TRIES IF IT DOESNT GET A SUCCESSFUL READ ІТ REFORTS А 

CRC ERROR FOLLOWED BY THE TRACK %. THESE VERSIONS OF LDOS COULD 

BE SAVED ON CASSETTE FOR DIAGNOSTIC TESTS IN CASE A DISK WON'T 

LOAD. 

DISK VERSIONS ОҒ LDOS ARE INCLUDED ON THE MASTER DISK INCASE А CERTAIN 
PROGRAM MUST USE THE RAMTOP AREA. TO LOAD THESE PROGRAMS IN FIRST LOAD 
.IN LDOS48.C1 WHICH USES MEMORY FROM 48000 TO 52300 AND IS ENTERED BY А 
USR 48000 STATEMENT ОК LDOS28 WHICH USES MEMORY FROM 28000 TO 32300 
AND IS ENTERED BY А USR 28000 STATEMENT. THESE DOS’S FUNCTION THE 
VERY SAME AS THE EPROM VERSION. Ебі WHEN USING AN ASSEMBLER THAT 
RESIDES IN THE TOP OF RAM фМІ KEEPS ITS SOURCE CODE FROM 32768 ОМ» 
FIRST CLEAR 28000 THEN LOAD *'LDhOS28.C1*. А USR 28000 WILL ENTER LDOS 
THEN YOU CAN LOAD THE ASSEMBLER AND SOURCE CODE. THE EPROM IS AUTO- 
MATICALLY BANK SWITCHED OUT WHEN THE DISK VERSIONS ARE ENTERED. 
THE LENTH OF THE DISK UERSIONS IS 2200 RYTES. 





Continued 
MOVE , 
THIS СОММАМП IS USED FOR LOADING CODE FILES INTO А DIFFERENT AREA 
OF MEMORY THAN WHERE IT WAS SAVEL FROM. BEFORE USING FOKE LOCATIONS 
23540 (LSB) AND 23541 (MSE) WITH THE START ADDRESS OF WHERE THE CODE 


IS TO BE LOADED. 


COPY | 
THIS COMMAND IS ONLY ОМ (00528 BECAUSE ІТ USES ALL THE MEMORY ABOVE 


32768.1T IS USED TO COPY А FILE FROM ONE DISK TO AN OTHER.THE DOS 
WILL TELL YOU WHEN TO INSERT THE SECOND DISK. HIT ANY KEY WHEN READY. 
THIS COMMAND IS LIMITED TO А MAXIMUM FILE LENTH ОҒ 16 BLOCKS. 


ERRORS 
SYNTAX ЕК А SYNTAX ERROR OCCURS 
- WHEN А COMMANI! DOESN'T HAVE A LEGAL FILE NAME 
- WHEN THE COMMAND IN А REM STATEMENT ISN'T CORRECT 
NO FILE OCCURS WHEN 
- ON A LOAD OR DELETE IF FILE IS NOT ON [ISK 
- WHEN WORKING WITH ARRAYS»: IF THE DOS CAN'T FIND THE 
ARRAY IN MEMORY (BECAUSE THE DIM COMMAND WAS МОТ 
ЕХЕСМТЕП EEFORE THE DOS CALL). 


- OCCURS WHEN А SAVE IS ATTEMPTED ON A WRITE PROTECTED 
DISK { 
СЕС ER OCCURS WHEN DATA CANNOT BE READ AFTER 10 TRIES 
THE NUMBER INDICATES THE TRACK 4. 
DISK FULL - OCCURS WHEN THE DISK DOESNT HAVE ENOUGHT ROOM TO 
HOLD THE FILE BEING SAVED.THE FILE NAME WILL BE IN THE 
DIRECTORY EVEN THOUGHT THE DATA ISNT ON THE DISK SO 
THE FILE SHOULD BE DELETED. 
- OCCURS WHEN THERE ARE MORE THAN 54 ENTRYS IN THE 
DIRECTORY. 
VARIABLE NOT FOUND 
- OCCURS ON DISK DOS’S WHEN A STRING OR ARRAY CAN'T 
BE FOUND. . 


NOTES - SOMETIMES А FULL ER OR OTHER LDOS ERROR WILL BE QUICKLY OUER 
WRITTEN BY THE 2068 BASIC MESSAGES IF THE PRINT POSITION IS AT 
THE BOTTOM OF THE SCREEN. THIS COULD OCCUR IF THE USK CALL 
WAS & RANDOMIZE OR LET TYPE. SETTING THE PRINT POSITION AWAY 
FOR THE BOTTOM BY A PRINT АТ 0»0 COMMAND BEFORE THE USR CALL 
WILL ELIMINATE THIS FROM HAPPENING. 
- WHEN THE DISK DRIVE IS TURNED ON OR OFF THE DRIVE DOOR SHOULD BE OPEN 
TO PREVENT CURRENT GLITCHES IN THE WRITE CIRCUITRY FROM ERASING DATA 
IF THE DISK HAS А WRITE PROTECT STICKER ON IT THIS WON’T HAPPEN. 
USE WRITE FROTECT STICKERS WHEN EVER POSSIBLE. 
- THE SFECTRUM® ROM SWITCH’ FOR THE 2068 WILL WORK WITH THIS SYSTEM. 
IF YOU ARE USING THE SPECTRUM ROM IN YOUR 2068 THE COMPUTER WON’T 
TURN ON PROPERLY IF THE ЕРКОМ IS BANK SWITCHED IN. THEREFORE TO 
BANK SWITCH IT OUT YOU CAN SWITCH TO THE 2068 ROM AND DO AN OUT 8490 
COMMAND OR DISCONNECT THE POWER TO THE CONTROLLER BOARD MOMENTARILY. 
A CLEAR 61000 (OR LESS) MUST BE DONE BEFORE YOU CAN DO AN OUT 84,64 
COMMAND. е 
А BASIC PROGRAM MADE ON THE 2068 WON’T RUN ON THE SPECTRUM ANI! VICE 
VERSA WITH OUT MODIFICATIONS DUE TO THE FUNCTION DISPATCHER IN THE 2068. 
WHEN LOADING А SPECTRUM PROGRAM RAMTOP SHOULD BE THE SAME AS WHEN IT 
WAS SAVED. : 


PROT ERR 





WHEN THE DOS IS ENTERED АТ 63488 ІТ ALWAYS KELOCATES THE THREE 
ROUTINES INTO RAM AND SETS THIS VARIABLE АТ 150 BUT IF YOU ENTER 

THE DOS АТ 63499 ІТ WILL ENTER THE DOS WITH OUT CHANGING THESE 
ROUTINES»SO AFTER CHANGING THE FOKING THE NEW VARIABLE ENTER THE 

DOS АТ 63499. IT IS ОҒ COURSE NECESSARY TO HAVE ENTERED THE IOS АТ 
LEAST ONCE PREVIOSLY АТ 63488 TO HAVE TRANSFERED THESE ROUTINES INTO 


RAM. 


IOS USER SUBROUTINES 

FOUR SUBROUTINES WITH IN THE DOS MAY BE USEFULL TO THE USER FOR CUSTOM 

FILES OR DIRECTORY MOD’S ETC. THESE АКЕ LOADTRN»SAUETRN ANI! SETTRAC. 

- SETTRAC WHEN CALLED WILL SET THE DISK HEAL ON THE TRACK SFECIFIED 
BUY DOS VARIABLE "TRAC". TRAC MUST BE BETWEEN O AND 79. 

- LOAITRK WHEN CALLED WILL LOAD THE DATA FROM THE TRACK THE HEAD IS ON 
INTO THE DOS "BUFFER" AREA. THIS ROUTINE RETURNS WITH THE INTERUFTS 
DISABLED SO A EI INSTRUCTION SHOULD BE EXECUTED BEFORE THE ATTEMFTING 
TO REAL THE KEYBOARD. 

- SAVETRK WILL SAVE THE RUFFER AREA TO THE TRACK THE HEAL IS AT. 

- РКШІК FRINTS THE DIRECTORY ON THE SCREEN BEFORE THIS САМ BE USEL» 
THE CONTENTS ОҒ ТКК 0 SHOULD БЕ IN THE BUFFER AREA. 

USES OF THESE ROUTINES 

- А DELETED FILE CAN BE PUT BACK INCAS LONG AS ITS NATA TRACKS HAUN'T 
EEEN USED BY ANOTHER FILE) BY READING IN TRAC O (EITHER BY DIRECTORY 
COMMAND OR CALLING LOADTRK) THEN POKING THE FIRST LETTER OF THE FILE 
NAME IN THE DIRECTORY FROM 254 TO WHAT EVER IT WAS. THEN A SEARCH OF 
ALL THE TRACKS HAS TO BE MADE TO DETERMINE WHICH TRACKS THE FILE WAS 
ON DO A DIRECTORY NOW AND FOKE THE RECOVERED TRACK #°S INTO THE TRACK 
AREA OF THE NAME CELL THEN CALL SAVETRK.THEN LOAD THE FILE IN AND 
SAVE IT USING THE LOAD AND SAVE COMMANDS. 

- IF THE DIRECTORY WAS DAMAGED DUE TO TURNING THE РОМЕК ОМ OR OFF WITH 
THE DISK IN THE DRIVE ETC. A DIRECTORY FROM A NEWLY FORMATTED DISK 
COULD BE COFIED TO THE DAMAGED DISK. THEN SEARCH THROUGH ALL TRACKS 
TO FIND THE NAMES OF THE FILES ON THE TRACKS AND ENTER THEN IN THE NEW 
DIRECTORYS TRACK МАР AND IN THE DIRECTORY NAME CELLS WITH THE NAME. 
THEN CALL ЅАЧЕТКК, 


LDOS ADDRESSES 
EFROMDOS 110528 LDOS48 (00516 


LENTH 2048 2720 2500 2500 

SETTRAC 63952 28309 48309 16693 
LOADTRK 61163 28055 48055 16439 
SAVETRK 64909 29830 49819 18203 
SORT © 61095 28673 48673 17057 
WORKSPC 61440 > 30716 50500 19000 
TRAC 61441 30717 50501 19001 
PRDIR 64154 7 28511 48511 16895 


CLINE 61470 30746 50530 19030 





DOS FILE OFERATION 
WHEN THE IOS IS ENTERED АТ CHECKS TO SEE IF IT WAS CALLED FROM А 


RUNNING BASIC PROGRAM OR FROM IMMEDIATE МОРЕ (МО LINE NUMBER) BY 

FEEKING BASIC VARIABLE (23622) „ІР IT SEE'S A 255 THEN IT MEANS 

THAT THE PROGRAM WASN'T RUNNING AND THAT IT SHOULD PRINT *'LLDOS* 

AND ENTER THE KEYBOARD ІМРОТ ROUTINE. IF ІТ IS OTHER THAN 255 THEN 

IT WILL LOOK IN THE FOLLOWING REM STATEMENT FOR THE DOS COMMAND, 

EITHER WAY THE COMMAND WILL GET TRANSFERED TO AN INFUT BUFFER START- 

ING AT *CLINE* IN THE WORK SPACE AREA. THE 105 THEN JUMFS TO A 

ROUTINE CALLED "SORT" WHICH CHECKS СОММАМП SYNTAX AND JUMFS TO THE 

MAIN SUBROUTINES.THE WAY TO ENTER LDOS FROM ASSEMBLY LANGUAGE WOULD 

ЕЕ TO FUT YOUR COMMAND IN THE INFUT BUFFER STARTING АТ CLINE: EG. 

LOAD *XXXX.RX*' ANDI THEN CALL OR JUMP TO THE 005 AT 'SORT*. 

THE DOS EXITS FROM DIFFERENT ROUTINES IN DIFFERENT WAYS. DIR»FORMAT 

AND DELETE JUMF BACK TO THE KEYBOARD INFUT ROUTINE AND THEN NEED TO 

RE EXITED SO THESE САМ”Т ВЕ USED VERY WELL WITH IN А PROGRAM. 

THE SAVE COMMAND ALWAYS DOES A RETURN FROM DOS THE REGULAR WAY BY 

FOFING AN A ADDRESS FROM THE STACK ANI THEN JUMFING TO IT. 

THE LOAD COMMANI RETURNS IN DIFFERENT WAYS DEFENDING ON THE SITUATION 

- IF IT HAS LOADED А COME FILE '.CX' OR AN ARRAY '.AX* THEN IT DOES A 
REGULAR STACK RETURN. 

- IF IT HAS LOADED A BASIC PROGRAM THEN IT CHECKS TO SEE IF THE FROGRAM 
WAS RUNNING WHEN IT WAS SAVED BY FEENING BASIC VARIABLE 23622. IF IT 
DOES'NT SEE А 255 THEN THE PROGRAM WAS RUNNING AND IT DOES A REGULAR 
STACK RETURN AND THE FROGRAM WILL AUTO RUN.IF THE NUMBER IS 255 THEN 

IT FINDS THE ENTRY FOINT TO THE BASIC ROMS AUTO LIST ROUTINE BY FINDING 
THE ADDRESS FOINTED TO BY THE ADRESS HELE IN THE BASIC VARIABLE 23615. 
THIS IS USUALLY ADD 3725 (DEC) FOR THE 2068 AND 4867 (DEC) FOR THE 
SPECTRUM KOM. 

WHEN A BASIC PROGRAM IS SAVED THE INTERUFTS АКЕ DISABLED ANI! THE 
FROGRAM IS SAVED FROM ADDRESS 23546 TO THE ADDRESS IN THE VARIABLE 
E-LINE (23641) .THE STACK FOINTER IS SAVED ANI! ON THE 2068 THE STACK 
IS SAVED. THE STACK ISN'T SAVED ON THE SFECTRUM BECAUSE IT IS UF АТ 
RAMTOP , BECAUSE OF THIS А SFECTRUM BASIC PROGRAM SHOULD БЕ LOADER 
IN WITH RAMTOF SET THE SAME AS WHEN IT WAS SAVED. 


EPROM LDOS 
THE DOS ON THE EPROM DIFFERS FROM THE КАМ DOS'S IN THAT WHEN 


IT IS ENTERED IT FIRST RELOCATES»INTO RAM STARTING АТ 61010 » 
THREE SUBROUTINES THAT DIRECTLY CONTROL THE HARDWARE. THESE ARE 
THE DISK REAL SUBROUTINE? DISK WRITE SUBROUTINE AND THE KEYBOARD 
READ SUBROUTINE( THESE PERFORM BETTER IN RAM THAN ON EFROM DUE TO 
BANK SWITCHING SPEED LIMITATIONS).ALSO ЕРКОМ DOS IS ARRANGED 
DIFFERENTLY, THAN THE RAM VERSIONS SO SUBROUTINE ENTRY POINTS ARE 
DIFFERENT. THE DISK READ ROUTINE» SINCE IT IS RUN IN RAM CAN BE 
MODIFIED TO READ DISKS THAT WERE FORMATED ON A DISK DRIVE WHICH 
MAY NOT BE ALIGNED THE SAME AS YOUR DRIVE. THESE DISKS MAY GIVE 
CRC ERRORS WHICH WAY INDICATE THAT THE PREAMBLE DELAY ON THE DISK 
IS TO LONG OR TO SHORT FOR YOUR SYSTEM. IN THE DISK READ ROUTINE 
THERE IS A BYTE A LOCATION 61184 THAT IS INITIALLY SET AT 150.THIS 
IS THE PREAMBLE DELAY LOOP VARIABLE. THIS DELAY IS USED TO’ SYNC THE 
DATA SEPARATOR AT THE STAR} OF A READ ОРЕКАТІОМ, АҒТЕК THE INDEX 
PULSE HAS BEEN DETECTED. IF YOU GET CRC ERRORS READING A DISK FROM 
ANOTHER DISK DRIVE YOU CAN TRY CHANGING THIS VARIABLE (61164) TO 
DIFFERENT DELAYS BETWEEN READ ATTEMTS .TRY (10»50»,100,200»,0К 255) 
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PRINT USR vs RANDOMIZE ПӘН 
When to use 


One of the puzzling things about using the LARKEN DOS is the 
best choice of these two forms of USR calls. These notes will 
assist in the selection of the most appropriate version. 


Both forms produce essentially the same result. However there 
are circumstances where one or the other will prove to be a 
better choice. Primarily this has to do with the matter of 
print control on the screen. 


RANDOMIZE USR 

The RANDOMIZE USR command places the LDOS cursor а% the 
bottom of the screen (line 24). Subsequent calls to the 1005 
result in the original cursor being scrolled upwards, with the 
next cursor appearing immediately below it. In most cases this 
will prove to be the most appropriate choice. 


However there is an exception. This is in the case where a 
DIRE command is to be used. In this situation the use of the 
RANDOMIZE USR form will often result in a full screen display, 
followed rapidly by a blank screen, and an computer ‘Out of 
Screen' error report. This will occur if the directory is a 
particularly lengthy one, overflowing the screen area. 

Use of the PRINT USR command is indicated, whereby the 
Directory listing will commence at the top of the screen and, if 
the directory is very large, with а 'ѕсго11?' query at tne 
bottom. 


PRINT USR 
The PRINT USR command will result in the display of the LDOS 
cursor at the print position on the screen. That is to say, the 
LDOS cursor will appear at the point on the screen where the 
computer understands the next line of text is to appear on the 
screen. i.e. the system variable contained in address 23689. 
Thus, if the PRINT USR command is preceded by a CLS command, 
ог a PRINT AT 0,0 command the LDOS cursor will appear the the 
top left of the screen. This is ideal ,for example, when using 
the DIRE command,for it will result іп a full screen display of 
the directory, usually without requiring a scroll function. 


It may be noticed that use of the PRINT USR command results 
in a number, usually а 0, being displayed on the screen. This 
may or may not be found esthetically undesirable. 


LDOS16 APPLICATION 

sually it 1s easier to use the RANDOMIZE USR command with 
the LDOS16. However there may be occasions where it is preferred 
to use the PRINT USR command. When this is the case, special 
care has to be taken to ensure that the LDOS cursor (ог any 
other material, for that matter!) does not appear in the top 
third screen area where the LDOS16 resides, since this will 


corrupt the 1005. If the PRINT USR command із to be used, 
problems can be avoided by entering a PRINT AT 9,0 prior to the 
PRINT USR command, and as frequently as necessary to maintain 
control of the print position. A scroll function will shift the 
LDOS, thus ruining it. 


Тһе LDOS16 may refuse to respond to commands оп occasion 
without any apparent reason. The reason for this із not 
immediately obvious. However a close inspection of the screen 
may disclose a character "0" more or less in the centre of the 
LDOS16 display. This is an indication that a PRINT USR was used; 
the "O" represents the product which is displayed on the screen 
after each PRINT USR command, and which appears іп the print 
position immediately following the input command. This character 
"0" has corrupted the 100516 sufficiently to prevent normal 
operation. 


It was mentioned that the RANDOMIZE USR command was easier to 
use with the LDOS16. THis is because the LDOS cursor will appear 
on the bottom of the screen (line 24). The LDOS16 is also so 
arranged that subsequent appearances of the cursor,i.e. in the 
event of input errors,etc., will result in an upward scroll of 
the DOS display. At the same time the LDOS16 in the top third of 
the screen will not be disturbed until the cursor displays, іп 
moving upward, actually intrude into the LDOS area. 


The LDOS16 also has a unique arrangement whereby cursor 
appearances subsequent to the initial one are printed out as a 
continuation of the original line, and rolling over into the 
next line. Compare this to the other LDOS' where subsequent 
cursors are scrolled to the next line. What this does is give a 
great deal more flexibility in manipulating the screen DOS. 


The New Larken Disk-Operating System 
A system need not be complicated to be efficient! 
By 


David Solly 


When I was looking for a disk operating system the first 
thing І wanted was a system that would work on all of the ROM 
configurations available for the Timex Sinclair 2068. At that 
time I was running Mscript (с) on the TS 2068 КОМ, Tasword II 
(c) on the Spectrum Emulator, and Zterm Modem Software (c) on 
the Zebra П6--64 cartridge. Secondly, I was looking for a system 
which would leave me the largest amount of RAM possible because 
I was working mostly with large data-base and word processor 
type programs. Finally, I needed a system that would be simple 
to use and also within my limited budget. І searched іп vain 
until the answer appeared almost in my own back yard. 


The new Larken DOS developed by Larry Kenny (Larken 
Electronics, Navan, Ontario, Canada) was like having my every 
wish come true. The disk operating system (DOS) fits neatly onto 
a cartridge which loads into the Timex Command Cartridge Бау. 
For an а bit extra a second socket, fitted with a switch, can be 
added to the cartridge to hold any additional chip that the user 
may own such as a Spectrum Emulator or a Zebra 05-64. The rear 
board is a compact double-density disk interface which also has 
a Kempston joystick port and a Mon-maskable interrupt (NMI) push 
button. Because the DOS is burned into its own EPROM all the RAM 
is available to the user. The DOS is completely accessable 
whether you are using the standard TS 2068 ROM, the Spectrum 
Emulator ROM, or the Zebra O8-64 КОМ.  Frograms which are 
designed to run on both the TS 2068 and Spectrum Emulator need 
not be saved in two different formats to be reloaded into each 
ROM configuration. A formated double-sided, double-density 80 
track disk drive is capable of saving Воо of programs. 


Converting programs to run on the Larken DOS, once the 
hardware із installed and the DOS is called into operation by 
RANDOMIZE USR 100: ОРЕМН 4, "cd", is essentially а snap. The 
Larken DOS uses the same Sinclair tokens which are found on the 
key-board as the tape-driven system. After learning а few simple 
instructions and four mnemonic extensions, I was ready to handle 
most programs. The necessary adjustments needed to convert tape 
dirve commands to Larken DOS commands can be quicky illustrated 
by the following chart of equivalents. 
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Tape Drive Command 


The New LAREKEN DOS 


Lar ken DOS Command 


SAVE "Name" FRINT #4: SAVE "Мате. Bn" 

SAVE "Name" LINE 10 FRINT #4: SAVE "Name. Bn" LINE 10 

SAVE "Name" CODE [No equi val ent 1 

SAVE "Name" CODE s,1 PRINT #4: SAVE "Name.Cn" CODE s,1 

SAVE "Name" SCREENS FRINT #4: SAVE "Мате. Сп" SCREENS 

SAVE "Name" DATA АО ЕКІМТ #4: SAVE "Мате. Ап" DATA AC) 

SAVE "Name" DATA A#( FRINT #4: SAVE "Мате. АЖ" DATA АЖО) 

LOAD "" [CODE, etc. 1 [Мо equivalenti 

LOAD "Мате" PRINT #4: LOAD "Name. Bn" 

LOAD "Мате" LINE 10 FRINT #4: LOAD "Name. Bn" LINE 10 

LOAD "Name" CODE PRINT #4: LOAD "Мате. Сп" CODE 

LOAD "Name" CODE s PRINT #4: LOAD "Мате. Сп" CODE s 

LOAD "Name" CODE &,1 FRINT #4: LOAD "Мате. Cn" CODE &,1 

LOAD "Name" SCREENS PRINT #4: LOAD "Мате. Сп" SCREENS 

LOAD "Name" DATA AC) FRINT #4: LOAD "Name. An" DATA AC) 

LOAD "Name" DATA А) PRINT #4 LOAD "Name. AF” DATA AFC) 

VERIFY The use of VERIFY is different in 
Larken DOS than in the tape-driven 
system. It is used in the form: 
VERIFY "" to examin a formated 
disk for any bad blocks. 

MERGE "" [No equivalent] 

MERGE "Name" FRINT #4: MERGE "Name. Bn" 
A program merged with LEDOS will 
auto-run if a) if the program 
being merged was saved as an auto- 
run program or b) if there is a 
line of BASIC following the MERGE 
command which can be executed. 

Legend: n = any optional letter, number or graphics 5 = start 

address for machine codes 1 = lenght of machine code. 

A "Name" іп LEDOS can be any combination of letters, 


numbers and graphics upto to six characters plus the appropriate 
extension. The "Name" may also be in an alpha-numeric string so 
long as it follows the proper format and its total length is not 
longer than nine characters. If the "Name" is to be stored in a 
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DIM'ed alpha-numeric array, which I do not recommend although it 
can be done, then the array can not be апу longer than nine 
characters of which the final three characters must be the 
proper extension. 


The Larken DOS also has commands and error reports which are 
specific to its own operating system plus a number of extended 
BASIC commands. These commands are: 


1) PRINT #4: CAT "", 


This is a very useful command that not only allows the user 
to see what has been stored on the disk but also, thanks to the 
use of unique extensions, what kind of files have been stored, 
the length in blocks of each file, and the total number of free 
blocks available. In the TS 2068 ROM and the Zebra 05-64 ROM 
mode the user can also specify which type of file he wishes to 
be listed by entering, for instance, CAT ".B", when searching 
for just BASIC programs. Specific program names can alsa be 
searched in this manner. 


2) PRINT #4: OFEN# 2, "1р" 


This command will allow you to LFRINT and LLIST to а full 
size printer that uses a Aerco type printer interface. 


59 FORMAT and MOVE 


FORMAT and MOVE are supplied in the package as  sub-routines 
on cassette or disk. 


4) FRINT #4: ERASE "Name", 


This comand erases a file from the the disk and  frees up 
space used by that file. 


5) PRINT #4: GO TO (drive) 


This command selects any one of four possible drives. Also 
GO TO 5 is reserved for the future RAM disk. 


6) Extended BASIC Commands 


The extended BASIC commands available on Larken DOS allows 
the user to create geometric shapes with the DRAW апа CIRCLE 
commands and then to fill them with апу of 10 different 
patterns. Also available are a double FOKE command (also known 
in some BASIC’s as DORE), window creating commands, and a 
command which will read and LPRINT and ASCII text file directly 


from disk. 
7) Mew Error Reports 


Finally, the Larken BOS has a number of new error reports to 
make operations easier for the user. These reports are: 


§ ~ Protect Error 
T — File Not Found 
U ~ Disk Full 
V ~ Wrong File Type 
Ш — Invalid Command 
X ~ Cat Data Error 
~ CRC Error (number?) 


Larry tells me that he plans to add sequential file 
capabilities and other disk support software, 


The cost of the New Larken system, which does not f 
= 





disk drive or disk drive power supply, is USE Lig, 'P 
6.00 if you wish toa have the extra өсосес for — 


Emulator or Zebra 09-64 chip. 


Send your order tos Larken Elect. 
Canada, КАВ LHS. Telep í 





